package com.nari.ncps.screen.service.dryport;

import com.baomidou.mybatisplus.extension.service.IService;
import com.nari.ncps.screen.entity.dryport.DryportProdoperOwnCoal;
import com.nari.ncps.screen.vo.dryport.OwnCoalVO;

import java.util.List;

/**
 * <p>
 * 自有煤炭完成量 服务类
 * </p>
 *
 * @author xuesong
 * @since 2025-08-23
 */
public interface DryportProdoperOwnCoalService extends IService<DryportProdoperOwnCoal> {

    /**
     * 根据年份查询月度统计数据
     * @param year 年份
     * @return 月度统计数据列表
     */
    List<DryportProdoperOwnCoal> getMonthlyStatsByYear(Integer year);

    /**
     * 获取最新月度统计数据（最近6个月，按月份从小到大排序）
     * @return 最新月度统计数据列表
     */
    List<DryportProdoperOwnCoal> getLatestMonthlyStats();

    /**
     * 根据年月查询统计数据
     * @param year 年份
     * @param month 月份
     * @return 统计数据
     */
    DryportProdoperOwnCoal getStatsByYearAndMonth(Integer year, Integer month);
    
    /**
     * 获取自有煤炭情况VO（最近6个月）
     * @param year 年份（可选）
     * @return 自有煤炭VO列表
     */
    List<OwnCoalVO> getOwnCoalStatistics(Integer year);
}
